home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / bbs_door / fvote_27.zip / SYSOP.DOC < prev    next >
Text File  |  1996-01-21  |  18KB  |  415 lines
  1. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  2. FrEevOtE v2.7 Documentation
  3. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  4.  
  5. IMPORTANT NOTE (since version 2.4):
  6. This version has a bug fix for a major bug which caused user deletes! This bug
  7. occaisonally appeared after there were over 38 users in the user file. Please
  8. upgrade to this version as soon as possible! the stable versions are 2.5 or 
  9. 2.6 (as far as i know it looks pretty stable ...)
  10.  
  11. Welcome to FrEevOtE v2.7
  12.  
  13. What is Freevote?: Totally FREE voting door with the best features of them all
  14. I made it to compare to EZVote 6.1 and the Renegade BBS Software voting door.
  15. And I tried to make it better.
  16.  
  17. Why is it free?: Because I hate people who charge for voting doors! And I 
  18. don't have to worry about anything.
  19.  
  20. What's the difference from the first version?: Read WHATSNEW.DOC!
  21.  
  22. This door is a remake of an example door from OPENDOORS programming toolkit!
  23. I think I spent more time on this door by now than it would take me to write
  24. the original door. But still so that you know. Actually by this time it is 
  25. about 80% my code!
  26.  
  27. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  28. FEATURES!
  29. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  30.  
  31. So what are those cool features:
  32.  
  33. Up to 15 one-lined answers per question, or seven 2-lined answers, the 
  34. creator of the question chooses which!
  35.  
  36. Users can add questions if the sysop allows it!
  37.  
  38. Questions can be posted anonymously. Only the sysop will see who created it
  39. Even before he votes on the question (users can't see that)
  40.  
  41. Questions can allow multiple answers to be checked. To allow check all that
  42. applies kind of questions. This is chosen by the question creator
  43.  
  44. Users can change their previous votes if the sysop allows it!
  45.  
  46. Users can delete the questions they have created if the sysop allows it!
  47.  
  48. Up to 400 Questions!
  49.  
  50. A nice graph display of answers!
  51.  
  52. You can set the program to delete old questions if you like!
  53.  
  54. Answers can be added by user if the creator of the question allows it!
  55.  
  56. 4 ways of forcing voting (-F, -FQ, -FNQ and -FA command line arguments)!
  57.  
  58. let users see a message on how many they have not voted only, no voting
  59. (-FC argument)
  60.  
  61. multinode aware ... it locks files so two, or more, nodes can run at the 
  62. same time without anything bad happening.
  63.  
  64. Multitasker aware, it releases time slices.
  65.  
  66. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  67. FREEWARE!
  68. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  69.  
  70. This program is freeeware which means ya should not charge for it, unless the 
  71. cost covers your distribution charges. I accept donations but Ya don't need 
  72. to send no money .. the software is FREE!!!! Ya got too much to pay just 
  73. running a board!
  74.  
  75. This software is the copyright (c)1995 of George Lebl, excluding the parts 
  76. which were written by the author of opendoors, Brian Pirie. 
  77.  
  78. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  79. DISCLAIMER!
  80. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  81.  
  82. I think it would be really lame to blame anything on me since this is 
  83. freeware. So this means I'm not responsible for anything that happens to you
  84. by the use of any of the files in this package. This means if Freevote erases
  85. your hd and the monitor blows up and your house burns down and the russians
  86. drop an A-bomb on yer city ... I ain't responsible, You as a user are!
  87.  
  88. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  89. Other legal stuff
  90. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  91.  
  92. This package should not be altered, unless you ask my permission and i say 
  93. yes ... it should contain these files:
  94.  
  95. SYSOP.DOC
  96. FREEVOTE.EXE
  97. FREEVOTE.CFG
  98. WHATSNEW.DOC
  99. RESET.BAT
  100. FILE_ID.DIZ
  101. FREEVOTE.BAT
  102.  
  103. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  104. Getting newer versions!
  105. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  106.  
  107. Ok If you got WWW go to
  108.  
  109. http://www.azstarnet.com/~franz/
  110.  
  111. If ya only got ftp the files should be usually on
  112.  
  113. ftp.uniserve.com /pub/bbs_doors
  114. or 
  115. ftp.wustl.edu /pub/MSDOS_UPLOADS/bbs/doors
  116.  
  117. if ya only got internet e-mail use the e-mail freq site (it should work)
  118.  
  119. TO: getfile@peacebbs.org
  120. SUBJECT: <the file name goes here>
  121. put anything in the body
  122.  
  123. FIDO FREQing should be available at 1:300/705. by filename only.
  124.  
  125. or you can call my bbs and ask for verification! [520] 297-0889
  126.  
  127. The File naming covention since v2.0 is
  128.  
  129. FVOTE_??.ZIP
  130.       ^^
  131.       ||
  132.       +--- the version number ... (e.g. "27" for 2.7) 
  133.  
  134. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  135. Installation!
  136. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  137.  
  138. Well to get you up and running fast, let's get to the instalation. Copy all 
  139. files into a directory (e.g. C:\FREEVOTE) and edit the FREEVOTE.CFG file to 
  140. your systems specifications. You can also use the example freevote.bat and
  141. edit it to your system specifications and then run the program from that!
  142.  
  143. You should also run maintanance every day! This is done by the -M command
  144. line argument! The maintanance takes care of packing question and user file
  145. and deleting questions that are too old (if you set it up that way in the 
  146. .cfg file) It is not neccessary to run the maintanance but then if you delete
  147. a question it will decrease your 400 question limit, and if you have timed
  148. deletion set up it will not work. (BTW as a sysop you can create questions 
  149. that will never be deleted by the timed deletion!) Anywayz ... you should 
  150. make sure that nobody else is voting while you run the maintanance! Running 
  151. it in your nightly batch file is recomended!
  152.  
  153. If your bbs software cannot pass the comport information through the door 
  154. file, then edit the comport options in the .CFG file. If you run a multiple
  155. nodes on such a system create more .CFG files (e.g. FV1.CFG, FV2.CFG) edit
  156. these ... (You have to put all the settins in both af them!) and start the
  157. FREEVOTE.EXE with the -C option (e.g. FREEVOTE.EXE -Cfv1.cfg)
  158.  
  159. If you have a bbs software that passes the comport information leave the 
  160. comport settings in the .CFG file commented out. Even on a multinode system.
  161.  
  162. If you want to set up Freevote to tell the user if there are new questions or
  163. not set up your bbs software to run freevote during the user logon and run it 
  164. with the -FA parameter. this will count the questions the user has not 
  165. answered and ask him if he wants to go vote on them. If you want the user to 
  166. go vote on them right ahead without counting the questions, use the -F 
  167. parameter. If you want to prevent the user from quitting or skipping 
  168. questions and so forcing the user to vote on all the questions before he can
  169. procceed, use the -FNQ argument. This will force user to answer all questions
  170. and then it will just quit and never enter the main menu. Or if you want the
  171. questions to appear just as if they were in you bbs with no press enter mesages
  172. just the questions, use -FQ argument this will be the same as -FNQ but without
  173. the stupid messages:) Read more about this in the command line parameters 
  174. section of this manual!
  175.  
  176. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  177. Sample batch files:
  178. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  179. Let's say your bbs system is in c:\bbs your dropfiles for node 1 are in
  180. c:\bbs\node1, and in c:\bbs\node2 for node2 .. etc... Freevote is installed
  181. in c:\doors\freevote. This is example batch file which would be called with 
  182. one command line argument which would be the node number (e.g. 
  183. "FREEVOTE.BAT 2" for node 2)
  184.  
  185. FREEVOTE.BAT
  186.  
  187.   @echo off
  188.   c:
  189.   cd \doors\freevote
  190.   REM change to the freevote dir
  191.  
  192.   freevote -n%1 -pc:\bbs\node%1
  193.   REM call freevote with -n<node number> and -p<dropfile path> arguments
  194.  
  195.   cd \bbs\node%1
  196.   REM get back to you bbs\node<node number> directory
  197.  
  198. In your nightly maintanance batch file you would add:
  199.  
  200.   c:
  201.   cd \doors\freevote
  202.   REM change to the freevote dir
  203.  
  204.   freevote -m
  205.   REM call freevote to run maintanance
  206.  
  207. This setup should work for most systems. Just change the path to your 
  208. specifications.
  209.  
  210. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  211. Upgrading
  212. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  213.  
  214. From v2.x
  215. ---------
  216. Just unzip the executable into the Freevote directory. If you unzip the whole
  217. thing your freevote.cfg will be overwritten. since it did not change you do 
  218. not need to make any changes to it.
  219.  
  220. From v1 (freevote.zip)
  221. ----------------------
  222.  
  223. Delete everything in your current freevote directory and install it as new.
  224. There is no way to upgrade because v2 needs more info than is stored in the
  225. v1 files. So all your old questions will be lost. 
  226.  
  227. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  228. COMMAND LINE
  229. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  230.  
  231. Options:
  232.   
  233.   -C   =   Run the game with config file differen from FREEVOTE.CFG
  234.            (e.g. -Cfvalt.cfg = run FREEVOTE with the FVALT.CFG file)
  235.  
  236.   -L   =   Force local operation. Does not read the drop file and ask for 
  237.            your name.
  238.  
  239.   -P   =   Use drop file in dir specified after this option. You can also 
  240.            specify a drop file to use. (e.g. -Pc:\ra\doorinfo1.def)
  241.  
  242.   -F   =   Forces the user to vote on all new questions when he enters the
  243.            door then asks him if he wants to goto the menu or quit.
  244.  
  245.   -FA  =   Counts the questions the user has not answered and asks him if he
  246.            wants to enter the door. This is the most user friendly way of 
  247.            forcing voting. It also if there were questions and the user has 
  248.            voted on all of them, it asks him if he wants to enter the main
  249.            menu or just quit to the BBS. 
  250.  
  251.   -FNQ =   Forces the user to vote on all new questions when he enters the 
  252.            door but he HAS to answer the question, he cannot [S]kip nor [Q]uit
  253.            after he answers all questions the door exits so the user doesn't
  254.            actually get into the main menu. This is good if you need some 
  255.            system oriented questions to be asked and want all the users to
  256.            answer! Just put "freevote -fnq" into the login sequence. 
  257.   
  258.   -FQ  =   Same as -FNQ but it is a quiet mode so no messages like press 
  259.            enter or returning or you have voted on .... it's just the 
  260.            questions nothing else.
  261.  
  262.   -FC  =   like -FA, but it is does not ask the user if he wants to enter the 
  263.            door it will just cound the unanswered questions display that 
  264.            message to the user and say press enter to continue and then it 
  265.            quits thi sis good for adding just a message to your logon wthout 
  266.            making it messy.
  267.   
  268.   -N   =   Set node #. It is only used in the status line.
  269.  
  270.   -LOG =   Log the usage into "FREEVOTE.LOG" file. It was default in v1, but
  271.            it bugged me so I made it only an option
  272.  
  273.   -RDBPS = Forces the game to read the locked port rate. This was default in 
  274.            the past and had caused problems!. This argument is only used for
  275.            solving problems with locked bps fossil driver setups!
  276.  
  277.   -M   =   Run maintanance! This should be run once a day while nobody else is 
  278.            online! It only runs in local mode! Running "FREEVOTE -M" in your
  279.            nightly maintanance file is recomended!
  280.  
  281. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  282. Problems, Special Setups!
  283. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  284. If you have problems with reading the dropfile. you might try editting the
  285. BBSDir parameter in the .cfg file. then you would call freevote without 
  286. any parameters.
  287.  
  288. If you have this problem on a multinode system, create a .cfg file for every
  289. node (e.g. FV1.CFG, FV2.CFG ...) then call freevote with just the -C 
  290. parameter.
  291.  
  292. for example for node 2:
  293.  
  294. freevote -Cfv2.cfg
  295.  
  296. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  297. If you want multiple sessions of freevote, like if you wanted to have one for
  298. system specific questions and one for user questions and fun. Then you'll
  299. have to create two different directories and install it like two separate 
  300. doors! There are yet no specific functions for this.
  301.  
  302. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  303. That's IT!!!
  304.  
  305. You've done it ....
  306.  
  307. run FREEVOTE -L to test it local, and enjoy the voting
  308.  
  309.  
  310. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  311. REGISTRATION:
  312.  
  313. What ... Ya wanna register a freeware ... oh well if u really needta send me
  314. some beer money .. but remember i only made the door better, not designed it.
  315.  
  316. If you have some money that you really have to send me, ok sure, please do!
  317. Or you just wanna bitch about something regarding the software!
  318.  
  319. Franz
  320. 12460 n granville cyn way
  321. tucson,az 85737
  322. USA
  323.  
  324. Donations should be cash or money order only!!!! I don't wanna deal with 
  325. returned checks or stuff like that. But remember it's not a shareware and you
  326. don't have to pay .. but it will prolly make me make the door better than it 
  327. is.
  328.  
  329. anywayz ... just enjoy .. ya don't heftta pay ... oh yeah if ya want to send 
  330. me comments about it send it to
  331.  
  332. franz@azstarnet.com
  333.  
  334. and look at my page (will have the newest ver of FrEevOtE!)
  335.  
  336. http://www.azstarnet.com/~franz/
  337.  
  338. new files are usually on
  339.  
  340. ftp.uniserve.com /pub/bbs_doors
  341. or
  342. ftp.wustl.edu /pub/MSDOS_UPLOADS/bbs/doors
  343.  
  344. if ya wanna call my bbs call (you can d/l all my stuff on fisrt call!):
  345.  
  346. Franz's BBS [520] 297-0889
  347.  
  348. There needs to be a free door like this don't ya think.
  349.  
  350. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  351. SUGGESTIONS:
  352. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  353.  
  354. Anywayz if you find something you like on other doors or you just made it up
  355. bitch to me about it and maybe i will make another version. Lately due to
  356. requests and bug reports i have released 3 version in one week! (2.4, 2.5 and
  357. 2.6) and now due to requests i released 2.7
  358.  
  359. There are two effective ways of getting me to do something, send me 20 e-mails
  360. a day, send me money, buy me a beer, well that's three ...:)
  361.  
  362. Have phun and go vote!
  363.  
  364. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  365. Other software I wrote:
  366. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  367.  
  368. New York 2008: RPG Door Game .. LORD alike but a bit more complicated and 
  369.                certainly different setting! (shareware $15)
  370.                (newest version as of this v0.04)
  371.  
  372. FrEevOtE: Well that's this little program (freeware)
  373.           (newest version as of this v2.7)
  374.  
  375. KeWlcHaT: Sysop chatting/paging door, pretty kewl but simple. (freeware)
  376.           (newest version as of this v1.0)
  377.  
  378. BULLS: ANSI, ASCII bulletin maker, very simple but I use it all the time!
  379.        (freeware) (newest version as of this v1.2)
  380.  
  381. Jackpot: New York 2008 IGM. (freeware, source released for v1.0)
  382.          (lost the source to the latest version in an HD crash)
  383.          (newest version as of this v1.2 development stopped!)
  384.  
  385. Franz's Bar: New York 2008 IGM. ($1-donation-ware) (lost the sourcein a crash)
  386.              (newest version as of this v1.3 development stopped!)
  387.  
  388. Shoot Em: New York 2008 IGM. ($1-donation-ware) (lost the sourcein a crash)
  389.           (newest version as of this v1.1 development stopped!)
  390.  
  391. HIDET: Encryption program (almost shareware, I require a $10 payment, but
  392.        there is no crippling and i released the source) Unbeatable but slow
  393.        Latest version is v2.2 which is stable and probably the last version
  394.        anybody interested i will e-mail the source or encryption algorithm.
  395.        It has a few neat things to it! I might rewrite the algorithm in C 
  396.        and make a cross platform encryption program. I'd consider it freeware!
  397.  
  398. Dirty Wall: A Wall program. The best looking, and the sloppiest written.
  399.             It consists of an RA script and a poster program which maintains
  400.             the wall. I never publicly released it and only installed it on 
  401.             a few bbses of my friends. actually it runs into multinode 
  402.             problems, it is slow but almost bugless. though as it is right now
  403.             each setup requires a separate build and so I can't release it yet!
  404.             If I get enough feedback about it I might make it a REAL door and
  405.             make it run good fast and on any system!
  406.  
  407. Battle: MARS Type programming game. For Windows 3.1. (wanted $10) but it again
  408.         ain't crippled and ain't really good, and does not follow standards
  409.         and i haven't received a single reg nor feedback in 3 years:)
  410.         (newest version as of this v1)
  411.  
  412. Things: REALLY STUPID program for Win3.1 If you find it DON't D/l it ... hehehe
  413.         You migth laugh yourself to death by it's stupidity. but it's 300k 
  414.         long! (newest version as of this v1)
  415.